

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">

<html>
<head>
<script type="text/javascript" src="helpman_topicinit.js"></script>

<title>Hyperlinks [Enterprise Architect User Guide]</title>

<meta name="keywords" content="Enterprise Architect, Sparx Systems, UML, Hyperlink,Hyperlink Element,Hyperlink Diagrams,Hyperlink To Matrix Profiles,Hyperlink To Help Topics,Hyperlink To Model Search,Hyperlink To Internet Facilities,Hyperlink To External Files,Hyperlink To Discussion Forum,Hyperlink As Sub Activities,Element,Element Hyperlink,Matrix Profile,Matrix Profile Hyperlink To,Help,Help Topic, Hyperlink To,Internet Facilities,Internet Facilities Hyperlink To,Discussion Forum,Discussion Forum Hyperlink To,Model Search,Model Search Hyperlink To,File,File Hyperlink To">
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
<meta http-equiv="Content-Style-Type" content="text/css" />

<link type="text/css" href="default.css" rel="stylesheet" />
<style type="text/css">
  A, A:Visited
  {
    color: #00F;
  }

  A:Active, A:Hover
  {
    color: #F00;
  }

  OL
  {
    margin: 5px 0 5px 48px;
  }

  UL
  {
    margin-bottom: 3px;
    margin-top: 0;
  }

  #nsr
  {
    background-color: #D4DFFF;
  }

  #nsr A
  {
    text-decoration: none;
  }

  #mainbody
  {
    padding: 8px;
  }

  .p_BodyText
  {
    padding: 5px 0;
  }
</style>



<style type="text/css" media="screen">
  BODY
  {
    background-color: #FFFFFF;
  }

  #nsr
  {
    padding: 6px 6px 0 6px;
    border-bottom: none;
    vertical-align: top;
    z-index: 2;
    visibility: visible;
    left: 0;
    top: 0;
    position: absolute;
  }

  #mainbody
  {
    left: 0;
    top: 0;
    margin: 0;
    position: absolute;
    padding: 10px;
    overflow: auto;
    height: 100%;
    z-index: 1;
    background-repeat: no-repeat;
    background-position: bottom right;
    background-attachment: fixed;
  }
</style>

<style type="text/css" media="print">
  #nsr
  {
    visibility: none;
  }

  #mainbody
  {
    overflow: visible;
  }
</style>
<script type="text/javascript" language="JavaScript" src="nonscroll.js"></script>

</head>
<body scroll="no">

<div id="page">



        <div id="content">
          <div id="content-inner">
          



  
          <div id="nsr">
            <table border="0" cellspacing="0" cellpadding="4" width="100%">
              <tr valign="top">
                <td align="left">
  


                  <p class="p_Heading1"><span class="f_Heading1">Hyperlinks</span></p>



  
                </td>
                <td align="right">
                  <a href="introduction.htm" onmouseover="document.images.main.src='button_main_h.gif'" onmouseout="document.images.main.src='button_main.gif'">
                    <img name="main" src="button_main.gif" border=0 alt="Return to Introduction">
                  </a>&nbsp;
    
                  <a href="feature.htm" onmouseover="document.images.prev.src='button_prev_h.gif'" onmouseout="document.images.prev.src='button_prev.gif'">
                    <img name=prev src="button_prev.gif" border=0 alt="Previous page" />
                  </a>&nbsp;
    
    
    
                  <a href="n_aryassociation.htm" onmouseover="document.images.next.src='button_next_h.gif'" onmouseout="document.images.next.src='button_next.gif'">
                    <img name=next src="button_next.gif" border=0 alt="Next page" />
                  </a>
    
    
                </td>
              </tr>
            </table>
          </div>
          <div id="mainbody">
  


                <p class="p_TextIndentedL2"><img src="hyperlink.png" width="26" height="26" border="0" alt="Hyperlink"></p>
<p class="p_BodyText"><span class="f_BodyText">You can place a</span><span class="f_BodyText" style="font-style: italic;"> Hyperlink</span><span class="f_BodyText"> element onto a diagram. This element is a type of </span><span class="f_BodyText">text</span><span class="f_BodyText"> element, but one that can contain a pointer to a range of objects such as associated document files, web pages, Help, model features and even other Enterprise Architect model files. When you double-click on the element, Enterprise Architect executes the link. To add a Hyperlink element, drag the </span><span class="f_BodyText" style="font-style: italic;">Hyperlink</span><span class="f_BodyText"> icon from the </span><span class="f_UIControl">Common</span><span class="f_BodyText"> page of the Enterprise Architect UML </span><span class="f_UIControl">Toolbox</span><span class="f_BodyText"> onto the diagram.</span></p>
<p class="p_BodyText"><span class="f_BodyText">(Alternatively, click on the </span><span class="f_MenuKeyField">Hyperlink</span><span class="f_BodyText"> icon in the </span><span class="f_UIControl">Elements</span><span class="f_BodyText"> toolbar </span><img src="elementtoolbar.png" width="210" height="27" border="0" alt="ElementToolbar"><span class="f_BodyText"> </span><span class="f_BodyText">and then click on the diagram.</span><span class="f_BodyText">)</span></p>
<p class="p_SubHeadingL1"><span class="f_SubHeadingL1">Configure the Hyperlink</span></p>
<p class="p_BodyText"><span class="f_BodyText">When you add the Hyperlink to the diagram, the </span><span class="f_UIControl">Hyperlink Details</span><span class="f_BodyText"> dialog displays.</span></p>
<p class="p_TextIndentedL2"><img src="hyperlinkdlg.png" width="498" height="243" border="0" alt="HyperlinkDlg"></p>
<p class="p_BodyText"><span class="f_BodyText">You first select the type of object to link to, by clicking on the drop-down arrow in the </span><span class="f_MenuKeyField">Hyperlink Type</span><span class="f_BodyText"> field. The </span><span class="f_UIControl">Hyperlink Details</span><span class="f_BodyText"> dialog displays the appropriate fields, prompts or dialog to enable you to specify the object to link to. For example, if you intend to hyperlink to an attribute, the <a href="set_feature_dialog.htm">Set Attribute dialog</a> displays to enable you to select that attribute. If you intend to hyperlink to a diagram, the </span><span class="f_UIControl">Select a Diagram</span><span class="f_BodyText"> dialog displays, which enables you to select the diagram from anywhere in the project; you can filter the selection to diagrams of certain types.</span></p>
<p class="p_BodyText"><span class="f_BodyText">If you select </span><span class="f_MenuKeyField">EA Command</span><span class="f_BodyText">, the </span><span class="f_MenuKeyField">Hyperlink Address</span><span class="f_BodyText"> field changes to a drop-down list of Enterprise Architect commands. You can select </span><span class="f_MenuKeyField">LocalPath</span><span class="f_BodyText"> and click on the </span><span class="f_MenuKeyField">[ ... ]</span><span class="f_BodyText"> (Browse) button to display the </span><span class="f_UIControl"><a href="localpathdlg.htm">Local Paths</a></span><span class="f_BodyText"><a href="localpathdlg.htm"> dialog</a>, which you complete as required. Subsequently, when you click on the hyperlink the </span><span class="f_UIControl">Local Paths</span><span class="f_BodyText"> dialog immediately displays and you can apply, switch, expand or update the current path.</span></p>
<p class="p_BodyText"><span class="f_BodyText">Once you have defined the object and its location, you can change the location either by overtyping the </span><span class="f_MenuKeyField">Hyperlink Address</span><span class="f_BodyText"> field or by clicking on the </span><span class="f_MenuKeyField">[ ... ]</span><span class="f_BodyText"> (Browse) button.</span></p>
<p class="p_BodyText"><span class="f_BodyText">In the </span><span class="f_MenuKeyField">Alias</span><span class="f_BodyText"> field, type the text to display in the hyperlink. If you do not provide an alias, either the text defaults to the link itself, or (for certain link targets such as a matrix profile) the dialog generates a simple text instruction.</span></p>
<p class="p_BodyText"><span class="f_BodyText">If you prefer to display only the hyperlink text, without the icon, select the </span><span class="f_MenuKeyField">Hide Icon</span><span class="f_BodyText"> checkbox.</span></p>
<div style="text-align: left; text-indent: 0px; padding: 0px 0px 0px 0px; margin: 5px 0px 5px 13px;"><table cellspacing="0" cellpadding="2" border="0" style="border: none; border-spacing:0px;">
<tr style="text-align:left;vertical-align:bottom;">
<td valign="bottom" width="955" bgcolor="#efeff7" style="width:955px; background-color:#efeff7;"><p class="p_TiporNote" style="border-top: none; border-right: none; border-left: none;"><span class="f_TiporNote">Notes:</span></p>
</td>
</tr>
<tr style="text-align:left;">
<td width="955" bgcolor="#f7f7ff" style="width:955px; background-color:#f7f7ff;"><ul style="text-indent: 0px; margin-left: 14px; list-style-position: outside;">
<li><span class="f_TiporNoteText">If required, you can create a number of empty hyperlinks to complete later. If you then double-click on an empty hyperlink, the </span><span class="f_UIControl">Hyperlink Details</span><span class="f_TiporNoteText"> dialog displays and you can enter the details.</span></li>
<li><span class="f_TiporNoteText">Once you have created the hyperlink, you can also edit the hyperlink text by clicking once on the field, once on the text, then right-clicking and selecting the </span><span class="f_MenuKeyField">Edit Selected</span><span class="f_TiporNoteText"> context menu option.</span></li>
</ul>
</td>
</tr>
</table>
</div>
<p class="p_BodyText"><span class="f_BodyText">Note that you can add notes to the hyperlink, which display in the</span><span class="f_UIControl"> Hyperlink Details</span><span class="f_BodyText"> dialog when you right-click on the hyperlink and select the </span><span class="f_MenuKeyField">Properties</span><span class="f_BodyText"> context menu option. You can format these notes using the </span><span class="f_UIControl"><a href="rich_text_notes_toolbar.htm">Rich Text Notes</a></span><span class="f_BodyText"> toolbar.</span></p>
<p class="p_BodyText"><span class="f_BodyText">There are three alternative methods of creating a hyperlink, as explained in the following sections.</span></p>
<p class="p_SubHeadingL2"><span class="f_SubHeadingL2">Create Hyperlink To File</span></p>
<p class="p_BodyText"><span class="f_BodyText">You can create a hyperlink on a diagram to an external file simply by clicking on the file in a file list (such as Windows Explorer) or on your Desktop and dragging it onto the diagram. A short context menu displays with two options - </span><span class="f_MenuKeyField">Hyperlink</span><span class="f_BodyText"> and </span><span class="f_MenuKeyField">Artifact</span><span class="f_BodyText">. Click on the </span><span class="f_MenuKeyField">Hyperlink</span><span class="f_BodyText"> option to create the hyperlink on the diagram. The link is effective immediately, and you can right-click on it to add or change properties as described above.</span></p>
<p class="p_SubHeadingL2"><span class="f_SubHeadingL2">Create Action As Hyperlink</span></p>
<p class="p_BodyText"><span class="f_BodyText">You can create an <a href="actionnotation.htm">Action</a> element to represent a wide range of behaviors and actions, including a hyperlink. To do this, follow the steps below:</span></p>
<ol style="text-indent: 0px; margin-left: 48px; list-style-position: outside;">
<li value=1><span class="f_NumberedList">Drag an Action element from the </span><span class="f_UIControl">Activity</span><span class="f_NumberedList"> page of the </span><span class="f_UIControl">Toolbox</span><span class="f_NumberedList"> onto the diagram. A context menu immediately displays.</span></li>
<li value=2><span class="f_NumberedList">Select the </span><span class="f_MenuKeyField">Other</span><span class="f_NumberedList"> menu option. The </span><span class="f_UIControl">New Action</span><span class="f_NumberedList"> dialog displays, with the </span><span class="f_MenuKeyField">Other</span><span class="f_NumberedList"> radio button selected.</span></li>
<li value=3><span class="f_NumberedList">Click on the drop down arrow on the field in the </span><span class="f_UIControl">Select kind</span><span class="f_NumberedList"> panel, and click on </span><span class="f_MenuKeyField">Hyperlink</span><span class="f_NumberedList">.</span></li>
<li value=4><span class="f_NumberedList">Click on the </span><span class="f_MenuKeyField">OK</span><span class="f_NumberedList"> button. The </span><span class="f_NumberedList" style="font-style: italic;">Hyperlink Action</span><span class="f_NumberedList"> element displays on the diagram.</span></li>
<li value=5><span class="f_NumberedList">Right click on the element and select the </span><span class="f_MenuKeyField">Advanced | Set Hyperlink</span><span class="f_NumberedList"> menu option. The </span><span class="f_UIControl">Hyperlink Details</span><span class="f_NumberedList"> dialog displays.</span></li>
<li value=6><span class="f_NumberedList">Set the hyperlinks properties as described above.</span></li>
</ol>
<p class="p_SubHeadingL2"><span class="f_SubHeadingL2">Create Hyperlink Between Diagrams</span></p>
<p class="p_BodyText"><span class="f_BodyText">To create a hyperlink between diagrams, follow the steps below.</span></p>
<div style="text-align: left; text-indent: 0px; padding: 0px 0px 0px 0px; margin: 5px 0px 5px 13px;"><table cellspacing="0" cellpadding="2" border="0" style="border: none; border-spacing:0px;">
<tr style="text-align:left;vertical-align:bottom;">
<td valign="bottom" width="955" bgcolor="#efeff7" style="width:955px; background-color:#efeff7;"><p class="p_TiporNote" style="border-top: none; border-right: none; border-left: none;"><span class="f_TiporNote">Note:</span></p>
</td>
</tr>
<tr style="text-align:left;">
<td width="955" bgcolor="#f7f7ff" style="width:955px; background-color:#f7f7ff;"><p class="p_TiporNoteText"><span class="f_TiporNoteText">If the hyperlink appears as a Sub Activity, select the </span><span class="f_MenuKeyField">Tools | Options | Diagram | Behavior</span><span class="f_TiporNoteText"> menu option and deselect the </span><span class="f_MenuKeyField">Use Automatic SubActivities</span><span class="f_TiporNoteText"> checkbox.</span></p>
</td>
</tr>
</table>
</div>
<ol style="text-indent: 0px; margin-left: 48px; list-style-position: outside;">
<li value=1><span class="f_NumberedList">Open the diagram in which to display the hyperlink to another diagram. From the </span><span class="f_UIControl">Project Browser</span><span class="f_NumberedList"> select the diagram you want to create a hyperlink to.</span><br>
<span class="f_NumberedList">&nbsp;</span><br>
<img src="hyperlinkprojview.png" width="264" height="146" border="0" alt="HyperlinkProjView"><br>
<span class="f_NumberedList">&nbsp;</span></li>
<li value=2><span class="f_NumberedList">D</span><span class="f_NumberedList">rag the diagram on to the current diagram. The </span><span class="f_UIControl">Select Type</span><span class="f_NumberedList"> dialog displays.</span><br>
<span class="f_NumberedList">&nbsp;</span><br>
<img src="optionhyperlink.png" width="241" height="144" border="0" alt="OptionHyperlink"><br>
<span class="f_NumberedList">&nbsp;</span></li>
<li value=3><span class="f_NumberedList">Select the </span><span class="f_MenuKeyField">Hyperlink</span><span class="f_NumberedList"> option and click on the </span><span class="f_MenuKeyField">OK</span><span class="f_NumberedList"> button. The final hyperlinked diagram should resemble the diagram below, where the </span><span class="f_NumberedList" style="font-style: italic;">Class</span><span class="f_NumberedList"> diagram is the diagram to which the </span><span class="f_NumberedList" style="font-style: italic;">Product Order</span><span class="f_NumberedList"> diagram hyperlinks (notice that the hyperlink icon is different).</span><br>
<span class="f_NumberedList">&nbsp;</span><br>
<img src="hyperlinkfinal.png" width="504" height="501" border="0" alt="HyperlinkFinal"></li>
</ol>




            </div>
          </div>
        </div>



</div>


</body>
</html>
